Apple II
Technical Notes
_____________________________________________________________________________
                                                  Developer Technical Support

GS/OS
#1:    Contents of the System and System Tools Disks

Revised by:    Matt Deatherage                                   January 1989
Written by:    Matt Deatherage                                  November 1988

This Technical Note describes the contents of the disks /SYSTEM.DISK and 
/SYSTEM.TOOLS found in Apple IIGS System Software 4.0, as well as the minimum 
files necessary to boot GS/OS.
Changes since November 1988:  Removed the APPLETALK directory from the 
GS/OS minimum requirements and corrected an error in the location of the 
FINDER.DEF file.
_____________________________________________________________________________


Introduction

This Technical Note gives a description of each of the files in the Apple IIGS 
System Software 4.0 package.  The package includes two disks, /SYSTEM.DISK and 
/SYSTEM.TOOLS; the former is a bootable disk, the latter is not.  /SYSTEM.DISK 
includes only one driver, while /SYSTEM.TOOLS includes several, as well as 
some utility programs.  This Note also includes information on the files which 
are required to boot GS/OS for your application.


Contents of /SYSTEM.DISK

PRODOS                          The boot file for GS/OS, PRODOS contains 
                                the code necessary to load GS/OS from any 
                                particular file system.  This file will be 
                                file-system dependent.  For example, the 
                                file PRODOS on a bootable disk in the 
                                ProDOS file system will be different than 
                                the file PRODOS on a bootable disk in the 
                                High Sierra file system.
SYSTEM                          The subdirectory containing most of the 
                                GS/OS files.
    START.GS.OS                 The file containing the GLoader and GQuit 
                                routines.  It loads the file GS.OS, which 
                                contains the rest of the operating system.
    GS.OS                       The remainder of GS/OS.
    ERROR.MSG                   A compiled file containing all error 
                                messages required by GS/OS.  This file is 
                                separate from GS.OS to provide easier 
                                support for international IIGS owners.
    FSTS                        The directory containing the file system 
                                translators to be loaded at boot time.
        PRO.FST                 The ProDOS FST.
        CHAR.FST                The character device FST.
    DRIVERS                     The directory containing all device 
                                drivers needed by GS/OS and the Toolbox 
                                (including the Print Manager and MIDI 
                                Tools).
        APPLEDISK3.5            The Apple 3.5 Drive device driver for 
                                GS/OS.
        CONSOLE.DRIVER          The text screen and keyboard device driver 
                                for GS/OS.
        IMAGEWRITER             The ImageWriter driver for the Print 
                                Manager.
        PRINTER                 The printer port driver for the Print 
                                Manager.
        MODEM                   The modem port driver for the Print 
                                Manager.
        PRINTER.SETUP           A file containing the default printer 
                                driver and port driver settings for the 
                                Print Manager.
    SYSTEM.SETUP                The directory containing all the 
                                initialization files to be executed at 
                                boot time.
        TOOL.SETUP              A required file that loads TS2, which 
                                contains all the patches to tools in ROM 
                                for ROM level 01.  TOOL.SETUP would 
                                attempt to load TS1 if executed on a 
                                machine with ROM level 00, but GS/OS will 
                                not boot on such a machine, therefore, TS1 
                                is not included.
        TS2                     All the patches to ROM tools for ROM level 
                                01.
    DESK.ACCS                   The directory containing all the classic 
                                and new desk accessory files to be loaded 
                                at boot time.
        CACHE.NDA               The new desk accessory which allows users 
                                to change the GS/OS cache size.
    START                       The boot program.  If this file exists, 
                                GS/OS will always launch it upon boot.  In 
                                this case, as in most cases, this is the 
                                Finder.  The Finder for System Disk 4.0 is 
                                version 1.2.
    TOOLS                       The directory containing tool files for 
                                all tools not in ROM.
        TOOL014                 Window Manager v2.3.
        TOOL015                 Menu Manager v2.2.
        TOOL016                 Control Manager v2.5.
        TOOL018                 QuickDraw Auxiliary v2.5.
        TOOL019                 Print Manager v2.2.
        TOOL020                 LineEdit v2.2.
        TOOL021                 Dialog Manager v2.3.
        TOOL022                 Scrap Manager v1.4.
        TOOL023                 Standard File v2.2.
        TOOL025                 Note Synthesizer v1.3.
        TOOL026                 Note Sequencer v1.3.
        TOOL027                 Font Manager v2.4.
        TOOL028                 List Manager v2.3.
        TOOL029                 ACE Tools v1.1.
        TOOL032                 MIDI Tools v1.2.
    FONTS                       The directory containing all fonts to be 
                                used by the system.
        COURIER.10              10 point Courier font.
        COURIER.12              12 point Courier font.
        GENEVA.10               10 point Geneva font.
        GENEVA.12               12 point Geneva font.
        HELVETICA.10            10 point Helvetica font.
        HELVETICA.12            12 point Helvetica font.
        SHASTON.16              16 point Shaston font.
        TIMES.10                10 point Times font.
        TIMES.12                12 point Times font.
        VENICE.14               14 point Venice font.
        FONT.LISTS              A file prepared by the Font Manager when 
                                FMStartUp is called the first time.  It 
                                contains information about all the fonts 
                                in the FONTS directory, and is only 
                                recalculated if the Font Manager 
                                reasonably believes the information has 
                                changed.
    P8                          The ProDOS 8 operating system, version 
                                1.7.
FINDER.DEF                      The file containing the defaults for the 
                                Finder.  This file must be present on the 
                                backup copy of /SYSTEM.DISK you use with 
                                the Installer program; the Installer will 
                                not be able to install GS/OS if this file 
                                is not present on /SYSTEM.DISK.
ICONS                           The directory containing all the icon 
                                files used by the Finder.
    FINDER.ICONS                The icons used by the Finder for all 
                                system files and devices.
APPLETALK                       A directory containing files to implement 
                                the AppleTalk networking protocols.  On 
                                this disk, this folder is empty.
BASIC.SYSTEM                    The ProDOS 8 BASIC command interpreter, 
                                version 1.2.
BASIC.LAUNCHER                  A short program which allows BASIC.SYSTEM 
                                to run AppleSoft program files which are 
                                opened from the Finder.


Contents of /SYSTEM.TOOLS

INSTALLER                       The Apple IIGS Installer program.  This 
                                program makes use of scripts found 
                                elsewhere on this disk to install parts of 
                                the system, as well as third-party 
                                applications, without the user needing to 
                                copy individual files.
ADV.DISK.UTIL                   The Advanced Disk Utility program which 
                                allows for partitioning of SCSI hard 
                                disks, as well as erasing, initializing, 
                                and zeroing volumes or partitions.
SYSTEM                          A directory containing additional parts of 
                                GS/OS not found on /SYSTEM.DISK.
    FSTS                        Additional File System Translators.
        HS.FST                  The High Sierra FST which allows GS/OS to 
                                access CD-ROM disks formatted in the 
                                international standard High Sierra or ISO 
                                9660 formats.  This FST is write-only; it 
                                only performs read operations.
    SYSTEM.SETUP                Additional initialization files.
        ATSETUP                 Determines if AppleTalk is active and 
                                loads appropriate files.
        ATSTART                 Starts AppleTalk.
        ATINIT                  Contains user configuration information.
        ATPATCH                 Implements the RPM, PAP, EP and ZIP 
                                AppleTalk protocols. 
        SPLOAD                  Implements ASP, which allows up to eight 
                                open network sessions at once.
        ATROM                   Contains new code replacing the AppleTalk 
                                ROM.
    DRIVERS                     Contains additional device drivers for 
                                GS/OS and the Toolbox.
        SCSI.DRIVER             The GS/OS driver for devices connected to 
                                the Apple SCSI interface card.  This 
                                driver is required for GS/OS to recognize 
                                such devices.
        UNIDISK3.5              The GS/OS driver for UniDisk 3.5 drives.  
                                This driver is required for proper 
                                operation of UniDisk 3.5 drives.  Using 
                                the UniDisk without this driver will 
                                eventually corrupt media.
        IMAGEWRITER             The ImageWriter driver for the Print 
                                Manager.
        IMAGEWRITER.LQ          The ImageWriter LQ driver for the Print 
                                Manager.  This driver currently has no 
                                more functionality than the ImageWriter 
                                driver.
        LASERWRITER             The LaserWriter driver for the Print 
                                Manager.  This driver works with any 
                                LaserWriter with PostScript.  It does not 
                                work with the LaserWriter IISC.
        PRINTER                 The printer port driver for the Print 
                                Manager.
        MODEM                   The modem port driver for the Print 
                                Manager.
        APPLETALK               The AppleTalk port driver for the Print 
                                Manager.  It works with whichever serial 
                                port is currently connected to AppleTalk.
        APPLE.MIDI              The Apple MIDI Interface driver for the 
                                MIDI Tools.
        CARD6850.MIDI           The driver for 6850-based MIDI interface 
                                cards (such as the Passport(TM) MIDI card) 
                                for the MIDI Tools.
        EPSON                   The Epson(TM) printer driver for the Print 
                                Manager.
        PARALLEL.CARD           A driver for some parallel printer 
                                interface cards for the Print Manager.  
                                This driver does not work with the Apple 
                                Parallel Interface Card.
        APPLEDISK5.25           The 5.25" disk driver for GS/OS.  This 
                                driver is required for GS/OS to recognize 
                                5.25" disk drives.
        AT.IW.PSETUP            This file contains the same information as 
                                the file PRINTER.SETUP for an ImageWriter 
                                printing through AppleTalk.  The Installer 
                                will replace the file PRINTER.SETUP on the 
                                destination disk with this file and rename 
                                it PRINTER.SETUP.
        AT.IWLQ.PSETUP          This file contains the same information as 
                                the file PRINTER.SETUP for an ImageWriter 
                                LQ printing through AppleTalk.  The 
                                Installer will replace the file 
                                PRINTER.SETUP on the destination disk with 
                                this file and rename it PRINTER.SETUP.
        EPSON.PSETUP            This file contains the same information as 
                                the file PRINTER.SETUP for an Epson 
                                printing through the Parallel Card driver.  
                                The Installer will replace the file 
                                PRINTER.SETUP on the destination disk with 
                                this file and rename it PRINTER.SETUP.
        IW.PSETUP               This file contains the same information as 
                                the file PRINTER.SETUP for an ImageWriter 
                                printing through the printer port.  The 
                                Installer will replace the file 
                                PRINTER.SETUP on the destination disk with 
                                this file and rename it PRINTER.SETUP.
        IWLQ.PSETUP             This file contains the same information as 
                                the file PRINTER.SETUP for an ImageWriter 
                                LQ printing through the printer port.  The 
                                Installer will replace the file 
                                PRINTER.SETUP on the destination disk with 
                                this file and rename it PRINTER.SETUP.
        LW.PSETUP               This file contains the same information as 
                                the file PRINTER.SETUP for an LaserWriter 
                                printing through AppleTalk.  The Installer 
                                will replace the file PRINTER.SETUP on the 
                                destination disk with this file and rename 
                                it PRINTER.SETUP.
    DESK.ACCS                   Additional desk accessories.  This 
                                directory is currently empty.
    TOOLS                       Additional tools.  This directory is 
                                currently empty.
    FONTS                       Additional fonts.  This directory is 
                                currently empty.
    APPLETALK                   This directory contains additional 
                                AppleTalk files and utilities.
        NAMER                   This directory contains the Namer II 
                                application to rename AppleTalk devices.
            MTXABS.0            MouseText code routines for by Namer II.
            NAMER.II            The Namer II application (a ProDOS 8 
                                program).
            NAMER.0             Additional code needed by Namer II.
        CHOOSER                 This directory contains the Chooser II 
                                application to allow eight-bit 
                                applications to choose an AppleTalk 
                                printer for output through slot 7.
            CHOOSER.II          The Chooser II application (a ProDOS 8 
                                program).
            CHOOSER.0           Additional code needed by Chooser II.
            CHOOSER1.OVR        An additional overlay file needed by 
                                Chooser II.
            CHOOSER2.OVR        An additional overlay file needed by 
                                Chooser II.
            CHOOSER3.OVR        An additional overlay file needed by 
                                Chooser II.
            CHOOSER4.OVR        An additional overlay file needed by 
                                Chooser II.
            CHOOSER5.OVR        An additional overlay file needed by 
                                Chooser II.
            IWEM                The ImageWriter emulator program.  This 
                                file contains a PostScript program which 
                                Chooser II downloads to the LaserWriter.  
                                It enables eight-bit ProDOS 8 applications 
                                to print to slot 7 just as if they were 
                                printing to an ImageWriter in slot 7.  The 
                                ImageWriter emulator will convert the data 
                                to appropriate PostScript commands and 
                                print it.
            MTXABS.0            MouseText code routines for Chooser II.
    ICONS                       Additional icons for the Finder.  This 
                                folder is currently empty.
    SCRIPTS                     This directory contains all the scripts 
                                for the Installer.  On launch, the 
                                Installer will look in the same directory 
                                from which it was launched for the SCRIPTS 
                                folder and will use the scripts, which are 
                                ordinary text files, found within.
        ADV.DISK.UTIL           Script to install the Advanced Disk 
                                Utility program.
        APPLE.MIDI              Script to install the Apple MIDI Interface 
                                driver.
        APPLEDISK5.25           Script to install the 5.25" disk driver 
                                for GS/OS.
        ATIMAGEWRITER           Script to install the ImageWriter printer 
                                driver for the Print Manager, as well as 
                                the files necessary to work with 
                                AppleTalk.
        ATIMAGEWRITERLQ         Script to install the ImageWriter LQ 
                                printer driver for the Print Manager, as 
                                well as the files necessary to work with 
                                AppleTalk.
        CARD6850.MIDI           Script to install the 6850-based MIDI 
                                Interface card driver.
        CATALOG                 Script to force the Installer to show 
                                files on the destination volume.
        CDROM                   Script to install the High Sierra FST as 
                                well as the SCSI driver for GS/OS.
        CHOOSER                 Script to install Chooser II and related 
                                AppleTalk files.
        DCIMAGEWRITER           Script to install the ImageWriter printer 
                                driver for the Print Manager, as well as 
                                the files necessary to connect it to a 
                                serial port.
        DCIMAGEWRITERLQ         Script to install the ImageWriter LQ 
                                printer driver for the Print Manager, as 
                                well as the files necessary to connect it 
                                to a serial port.
        EPSON                   Script to install the Epson printer driver 
                                for the Print Manager, as well as the 
                                Parallel Card driver.
        FONTS                   Script to install additional fonts.  No 
                                additional fonts are currently supplied.
        INSTAL.SYS.FILE         Script to install a minimal GS/OS system 
                                on a given destination volume.
        INSTALL.ALL             Script to install everything from the disk 
                                /SYSTEM.DISK or the disk /SYSTEM.TOOLS 
                                onto one destination volume.  The 
                                destination volume must be larger than 
                                800K.
        LASERWRITER             Script to install the LaserWriter printer 
                                driver for the Print Manager, as well as 
                                the files necessary to work with 
                                AppleTalk.
        NAMER                   Script to install Namer II and related 
                                AppleTalk files.
        SCSI.HARD.DISK          Script to install the SCSI driver for 
                                GS/OS.
        UNIDISK3.5              Script to install the UniDisk 3.5 driver 
                                for GS/OS.



Minimum GS/OS System Disk Requirements

The following files are required for GS/OS to boot.  This list does not 
address files needed by the Finder or the IIGS Toolbox.  Those files only 
required in certain circumstances are noted as such.

PRODOS
SYSTEM
    START.GS.OS
    GS.OS
    ERROR.MSG
    FSTS
        PRO.FST                 Required if ProDOS formatted disks are to 
                                be used.
        HS.FST                  Required if High Sierra or ISO 9660 disks 
                                are to be used.
        CHAR.FST
    DRIVERS
        APPLEDISK3.5            Required if Apple 3.5 Drives are to be 
                                used.
        UNIDISK3.5              Required if UniDisk 3.5 drives are to be 
                                used.
        SCSI.DRIVER             Required if SCSI hard disks connected to
                                Apple II SCSI cards are to be used.
        CONSOLE.DRIVER
    SYSTEM.SETUP
        TOOL.SETUP
        TS2
    DESK.ACCS                   Required if Desk Accessories are to be 
                                installed.  The required desk accessories 
                                should be placed in this folder.
        CACHE.NDA               Always include this desk accessory unless 
                                you cannot afford the disk space, which is 
                                quite unlikely since it's only 3K of 
                                space.
    START                       If the file START is not present, some 
                                other file that GS/OS will boot into must 
                                be present or booting will fail.  See the 
                                GS/OS Reference for more details.
    TOOLS                       Required if any of the RAM-based tools are 
                                to be used.  Those tool files must also be 
                                placed in this directory.
    FONTS                       Required if the Font Manager is to be 
                                used.
    P8                          Required if ProDOS 8 is to be used.
BASIC.SYSTEM                    Required if AppleSoft BASIC is to be used.
BASIC.LAUNCHER                  Required if the user will be allowed to 
                                open AppleSoft BASIC programs from the 
                                Finder.


Further Reference
_____________________________________________________________________________
o    GS/OS Reference, Volume 1

